Inside Macintosh: QuickDraw GX Objects /

Chapter 8 - Tag Objects / Tag Objects Reference

Functions / Manipulating Tag Object Properties

GXGetTagOwners

You can use the GXGetTagOwners function to determine the number of references to a particular tag object.

long GXGetTagOwners(gxTag source);

source

A reference to the tag object to find the owner count of.

function result

The owner count of the tag object referenced in the source parameter.

DESCRIPTION

The GXGetTagOwners function returns the owner count of the referenced tag object. The owner count is the current number of references to the tag object.

ERRORS, WARNINGS, AND NOTICES

Errors
tag_is_nil

SEE ALSO

Owner counts for tag objects are discussed in the section "Copying, Comparing, and Cloning Tag Objects" beginning on page 8-9, and in the section "Manipulating a Tag Object's Owner Count" beginning on page 8-11.

To increment the owner count of a tag, use the GXCloneTag function, described on page 8-17. To decrement the owner count of a tag, use the GXDisposeTag function, described on page 8-14.